Register the Mobile Tracker Device with MAP using a
SOAP Web Services Tool

Note: The API call described below requires authentication; your MAP username and password credentials must be used. You can easily pass these credentials in the API call within the SOAP header using the following format:

<soap:Header><username>my_username</username><password>my_password</password></soap:Header>

createAsset

Call the createAsset API from the DeviceManagementService. This allows you to create an asset object to be tracked. Input parameters are:

assetTypeVO group - This group of settings is used to define a type of thing to be tracked (cars, trucks, taxis, bicycles, etc). The following group of settings are tied to this general asset type:

• assetTypeId - For now, set to 1. Use the getAssetTypes request to find the list of available types. Asset type objects simply contain a name and description, allowing you to later sort/group devices based on these types (for example, differentiate cars from trucks, or red from blue).
• Name - This can be any name of your choosing. It is suggested that you pick something that describes the asset or vehicle.
• Description - This can be any description of your choosing. It is suggested that you pick something that describes the asset or vehicle.
• lastUpdated - (required) Set to the current date/time, this is stored along with the asset object for future reference.
• updatedBy - This is used to identify the user who created the asset object. Typically you will use the user ID returned in Step 1:MAP Account Creation.

Name - Text field naming the specific asset being tracked with this mobile tracker device (my car, bus, bike, etc.).

Description - Text description of the asset being tracked (my new car, my shuttle bus, my green bike, etc.).

deviceSerial - (optional) Used for storing a unique ID for the asset, such as license plate number, taxi ID, etc.

identificationNumber - Set to 1.

installationDate - (required) Set to current date/time, required format is yyyy-mm-dd HH:MM:SS.SSS (typically set to the time when the asset was created).

Status - Set to 1 (active).

On successful return an ID number will be created; this is the assetId representing this asset object. Take note of this number as it will be used in subsequent requests.

You've completed the createAsset process. Proceed to the createAssetConfiguration section where you will enable the tracking features of the mobile tracker device.

Back to Step 3 | Move to createAssetConfiguration